СправочникМенеджер.<Имя справочника>.НайтиПоНаименованию (CatalogManager.<Catalog name>.FindByDescription)
СправочникМенеджер.<Имя справочника> (CatalogManager.<Catalog name>)
НайтиПоНаименованию (FindByDescription)
Доступен, начиная с версии 8.0.
Синтаксис:
НайтиПоНаименованию(<Наименование>, <ТочноеСоответствие>, <Родитель>, <Владелец>)Параметры:
<Наименование> (обязательный)
Строка, содержащая искомое наименование.
<ТочноеСоответствие> (необязательный)
Определяет режим поиска по полному соответствию.
Поиск будет успешным, если строка поиска: в случае значения параметра Ложь - будет соответствовать левой части наименования; в случае значения параметра Истина - будет полностью совпадать с наименованием (за исключением "хвостовых" пробелов в наименовании).
Значение по умолчанию: Ложь.
<Родитель> (необязательный)
Родитель, в пределах которого нужно выполнять поиск. Если не указан, то поиск будет проводиться во всем справочнике.
<Владелец> (необязательный)
Владелец, в пределах которого нужно выполнять поиск. Если не указан, то поиск будет проводиться во всем справочнике.
Возвращаемое значение:
Тип: СправочникСсылка.<Имя справочника>, Неопределено.Ссылка на найденный элемент справочника.
Если не существует ни одного элемента с требуемым наименованием, то будет возвращена пустая ссылка.
Если для справочника наименование не задано (длина = 0) и поиск выполняется по полному соответствию, то будет возвращено Неопределено.
Описание:
Осуществляет поиск элемента по его наименованию.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Примечание:
Если существует несколько элементов с указанным наименованием, то будет найден только один из них.Пример:
| СтрокаНаименования = "USD"; Валюты = Справочники.Валюты; НайденнаяСсылка = Валюты.НайтиПоНаименованию(СтрокаНаименования); Если НайденнаяСсылка = Валюты.ПустаяСсылка() Тогда Сообщить("Валюты """ + СтрокаНаименования + """ еще нет"); КонецЕсли; |
Использование в версии:
Доступен, начиная с версии 8.0.